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The  Graphics-ori exited.  Interactive,  Finite  Element 
Time-sharing  System  (GIFTS),  written  by  Professor  A.  Kamel 
and  Hr.  Michael  VI.  McCabe  of  the  University  of  Arizona,  has 
been  implemented  on  the  PDP-1 1  at  the  Naval  Postgraduate 
School.  This  powerful  system  of  programs  was  installed  in 
a  manner  to  facilitate  its  modification  in  the  future.  A 
very  brief  description  of  the  GIFTS  system,  including  the 
Unified  Fata  Ease,  as  well  as  the  PEP-i 1  and  ESX-1 1 A  operatin 
system,  are  provided.  Finally,  a  systematic  approach  to 
building  and/or  modifying  the  GIFTS  system  in  the  future  is 
included.  The  approach  taken  includes  a  "File  Sorter"  pro¬ 
gram  which  removes  the  need  for  much  of  the  tedious  work 
associated  with  building  the  system. 
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I.  INTRODUCTION 


The  purpose  of  this  thesis  is  to  describe  the  process 
whereby  the  Graphics-oriented  Interactive  Finite  Element 
Time-sharing  System  (GIFTS)  was  implemented  at  the  Naval 
Postgraduate  School. 

Anyone  who  has  entered  a  problem  with  a  large  amount 
of  numerical  input  into  a  computer  knows  the  fear  of  making 
logical  or  typing  errors  which  will  go  undetected.  The 
GIFTS  system  goes  a  long  way  in  reducing  this  problem  by 
allowing  a  user  to  graphically  reproduce  the  problem  he/she 
has  entered  into  the  system.  The  solved  problem  can  be 
displayed,  as  well,  in  a  form  which  makes  the  effect  of  a 
given  loading  graphically  reproducible  at  any  time  in  the 
future. 

The  first  step  in  building  the  system  was  obtaining  the 
latest  version  (5.02)  of  the  taped  program  from  the  Inter¬ 
active  Graphics  Engineering  Laboratory  (IGEL)  of  the 
University  of  Arizona.  After  an  initial  attempt  at  "building" 
the  system  on  the  PDP-11  (using  the  methods  described  below) 
several  minor  errors  were  found.  These  errors  were  generally 
in  the  form  of  incomplete  revisions  and  were  easily  correct¬ 
able  with  telephone  assistance  from  one  of  the  developers, 

Mr.  Michael  W.  McOabe,  of  the  University  of  Arizona. 
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Since  the  average  mechanical  engineering  student  at  the 
Naval  Postgraduate  School  does  not  ordinarily  spend  time 
being  taught  on  a  computer  system  other  than  the  school's 
mainframe  (currently  the  IBM  360/67),  a  great  deal  of  time 
was  required  in  the  preparation  for  this  thesis  simply 
learning  the  PDP-11/50  and  the  RSX-11M  Operating  System. 
Since  it  is  expected  that  the  GIFTS  system  will  need  to  be 
revised  in  the  future,  it  became  obvious  that  an  important 
objective  of  this  thesis  was  to  develop  the  means  whereby 
changes  to  GIFTS  could  be  made  as  conveniently  and  "pain¬ 
lessly"  as  possible  without  the  need  for  a  student  or 
faculty  member  to  become  intimately  familiar  with  the 
PDP-11.  It  is  believed  that  this  objective  has  been  success 
fully  met  with  the  combination  of  a  File  Sorter  program 
(FILSOR)  and  two  "command1'  files.  The  net  impact  of  these 
three  programs  is  to  allow  a  most  powerful  Finite  Element 
Method  (FEM)  pre  and  post  processer  (plus  solver)  to  be 
completely  built  on  the  PDP-11  with  two  tapes,  two  commands, 
and  six  hours  of  time. 

It  is  believed  that  the  GIFTS  system  will,  in  the  future 
be  an  invaluable  teaching  aid  at  the  Naval  Postgraduate 
School. 


II.  DESCRIPTION  OP  GIFTS 


GIFTS  is  a  system  of  programs  used  in  solving  Finite 
Element  Problems.  This  statement  does  not  really  do  justice 
to  the  system  for  the  forte  of  the  system  is  not  in  its 
ability  to  mathematically  solve  problems  but  rather  in  its 
ability  to  reliably  and  fairly  completely  define  structural 
problems  which  are  to  be  solved.  It  allows  a  user  to: 

1)  Input  problem  parameters; 

2)  Observe  the  input  both  graphically  and  in  tabulated 
form; 

3)  Update  the  model;  and 

4)  Observe  the  output 

Many  problems,  due  to  their  sizes,  vail  be  outside  the 
range  of  the  "solver"  contained  in  the  program.  Put,  due 
to  the  highly  structured  nature  of  the  Unified  Data  Ease  (UD3) , 
other  systems,  more  powerful  in  this  area,  can  access  the 
data,  solve  the  problem,  and  return  the  solved  problem  to 
GIFTS  for  display. 

The  purpose  of  this  section  is  to  give  enough  of  a 
description  of  GIFTS  and  the  available  documentation  to 
assist  a  user  interested  in  solving  a  FEM  problem  to  find 
out  how  to  get  started  at  the  Naval  Postgraduate  School. 


A.  GIETS  DEVELOPERS 

C-IETS  was  written  'ey  Professor  Hussein  A.  Kamel  and 
Hr.  Michael  YJ.  McCabe  of  the  University  of  Arizona.  The 
system  is  constantly  being  revised/updated  as  the  need 
arises.  The  facility  for  expansion  of  the  system  is  built 
in  to  it  as  not  all  element  types  have  beera  implemented. 

As  updates  are  received,  they  can  be  implemented  by  the 
procedures  outlined  below  in  section  7. 

H.  SYSTEM  CAPABILITIES 

Much  of  the  information  included  in  this  section  is 
already  included,  in  substance,  in  the  "C-IPTS  Users’ 

Manual.”  It  is  the  purpose  here  to  synthesize  the  informa¬ 
tion  from  this  reference  needed  to  have  a  general  under¬ 
standing  of  the  system. 

A  list  of  the  several  program  modules  with  descriptions 
can  be  found  in  Appendix  A.  Each  has  a  purpose  in  formulating 
a  FEM  problem  and  more  than  one  module  is  necessary  to 
completely  formulate  a  problem.  However,  not  all  program 
modules  are  necessary  for  every  formulation. 

The  general  breakdown  of  the  module  types/purposes  is: 

1)  Model  Generation  and  Editing; 

2)  Load  and  Boundary  Conditions  Generation,  Display 
and  Editing;  and 

3)  General  Purpose  Computational  and  Result  Bispla” 
Modules. 
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In  addition,  there  are  nodules  available  (  out  not  ;/et 
implemented  at  the  IT  aval  Postgraduate  School)  to  inter¬ 
face  the  'll  PIS  system  with  other  Finite  Element  programs 
including: 

1 )  AN SYS 

2)  SAP 4 

3)  NASTRAI! 

The  purpose  of  these  interfaces  is  to  act  as  "interpreters" 
of  the  GIPIS  Unified  Data  Ease  in  order  that  the  generated 
model  may  he  solved  on  one  of  these  other  systems.  I he 
interface  program  also  takes  the  solutions  generated  by  the 
other  system  and  formats  them  back  into  the  UBP  for  GIPIS 
in  order  that  they  can  he  displayed. 

In  the  "GIPIS  Users’  Reference  Manual,"  it  is  stated: 
"the  generation  and  display  capabilities  of  GIFTS  go  beyond 
its  own  analysis  capabilities."  It  gives,  by  example,  the 
fact  that  the  GIFTS  system  can  generate  and  display  higher 
order  elements  while  not  (yet)  being  able  to  analyze  the 
results.  'Though  the  author  is  not  privy  to  a  timetable,  it 
is  expected  that  the  system  capabilities  will  increase  and 
can  ce  added  to  existing  capabilities  currently  at  the  Maval 
Postgraduate  School.  The  methodology  for  making  such  revi¬ 
sions  is  covered  below-  in  chapter  7. 


Fre  arid  Post  Processing  Capabilities 


r 


1 . 

a.  Pre  Processing 

The  GIFTS  system  is  capable  of  being  used  as  a 

pre-processor  for  other  systems.  It  accepts  commands  which 

allow  a  user  to  establish  the  geometry  of  a  model  and  to 

display  it  at  a  terminal  for  verification. 

Figure  1  is  an  example  of  the  prograra/user 

interaction  which  is  required  to  establish  the  geometry  of 

1 

a  plate  witn  a  hole  in  the  center.  Figure  2  is  the  resulti 
plot  with  elements  and  points  labelled.  Should  an  error  be 
made  during  the  session,  a  correction  can  be  made  before 
going  on. 

Also  available  to  the  user  are  a  variety  of 
tabulations  of  input  and  computed  data.  These  also  prove 
useful  in  the  verification  of  a  model. 

b.  Post  Processing 

Figure  3  depicts  the  results  of  the  solved  7211 

i 

problem  which  was  entered  as  in  section  l.a.  above.  It 
depicts  the  stress  contours  as  computed  by  (in  this  case) 
the  GIFTS  system  for  a  given  loading.  If  a  different 
solver  (e.0.  SAP4)  were  to  be  used,  the  interface  program 
would  " translate the  output  from  the  solver  into  the 
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This  problem  is  one  that  was  included  in  the  "GIFTS 
Primer"  which  was  written  at  IGFL,  University  of  Arizona. 
See  Appendix  T. 


C-IPPS  UL3  format  before  using  the  G-IPPS  modules  for  dis¬ 
playing  the  results. 

Phe  system  can  also  display  deflection  plots 
due  to  a  given  loading  as  well  as  computing  and  displaying 
time  domain  problems. 

2.  Solving  Capabilities 

She  system,  as  presently  configured,  is  capable 
of  solving  a  \'/ide  class  of  structural,  finite  element 
method  problems.  However,  there  are  some  limitations. 

Page  III-1  of  the  C-IPPS  User's  ' 'anual  lists  those  elements 
which  enjoy  "Pull  Support"  and,  also,  those  within  the 
categories:  "feneration  and  Display  Only"  and  "Storage 

Only."  A  user  should  be  aware  of  these  distinctions  before 
deciding  to  solve  a  problem  completely  by  SIPPS  or  by  GIPPS 
in  conjunction  with  another  system. 

0.  PITH  00NPUTPR  PAOSflAh 

If  loaded  all  at  once,  with  no  overlaying,  the  entire 
set  of  program/modules  would  take  up  to  perhaps  two  mega 
bytes  of  memory.  Since  it  is  not  desirable  (or  usually 
possible)  to  have  this  much  space  available  to  a  user,  the 
program  has  been  divided  into  several,  separately  executable 
modules  having  as  their  common  denominator  the  Unified  ata 
Ease. 

Each  program  is  called  up  (executed)  by  a  "HUN"  command. 
At  the  end  of  the  session  with  an  interactive  module,  a 


’'"SIT"  (or  similar)  command  is  given  which  causes  the 


module  to  update  the  data  case,  close  files  and  leave  the 
module.  To  enter  the  next  module  another  "AUII"  command  is 
giver.  and  so  forth. 

The  interactive  modules  accept  a  large  number  of  well- 
defined  commands.  Some  of  the  modules  have  similar  and 
even  duplicative  sub-objectives  and  therefore  contain 
nan;,-  of  the  same  commands .  Zach  program,  however,  has  its 
own  communications  subroutine  which  will  accept  commands 
only  valid  in  the  particular  nodule.  Several  different  type 
prompt  symbols  are  used  (>,  *,  ?,  blank)  which  make  the 
nature  of  the  input  (i.e.  alphanumeric,  integer  or  floating 
point)  less  ambiguous. 

As  it  was  earlier  stated,  overlaying  is  required  for 
most  modules  when  installed  on  the  PDP-11.  This  is  due  to 
a  S4Z  byte  limitation  for  any  program  segment.  The  overlay! 
schemes  ’used  for  the  several  modules  were  included  on  the 
tapes  received  from  the  IDL'D,  University  of  Arizona,  and 
are  duplicated  on  the  tapes  discussed  below  in  section  IV. A. 

One  of  the  capabilities  available  to  the  user  in  marr* 
modules  is  that  of  plotting  the  model  at  a  terminal.  This 
feature  obviously  requires  that  a  terminal  with  a  graphics 
capability  be  used.  The  terminal  for  which  the  SIPTS 
System  at  the  Laval  Postgraduate  School  (’IPS)  is  presently 


eared  is  the  Tektronix  4000  Series 


To  chan re  to  another 

type  ox  terminal  would  require  modifications  to  several  of 

2 

the  GIFTS  library  subroutines. 

D.  I  HZ  UITIPIMD  DATA  HAS,. 

Durin  ;  the  course  of  model  definition,  the  GIFTS  system 
opens,  performs  input/output  (I/O),  and  closes  files  on 
disc.  At  the  end  of  a  session  one  will  find  on  his/her 
disc  space  several  files  having  the  jobname  (specified 
by  the  user)  as  their  filenames  but  each  havin';  a  different 
"extension. "  These  files  represent  the  Unified  fata 
base  (ITS-). 

The  UD3  files  created  by  GIFTS  are  primarily  random 
access,  unformatted  disc  files.  The  fact  they  arc  unformatted 
names  storage  of.  numerical  data  more  efficient  and  the 
random  access  feature  allows  for  easier  identification  of 
a  particular  record  to  be  read  or  written. 

1.  f efinition  of  "erms 

The  individual  files  are  described  in  the  "GIFTS 
Systems  Manual"  but  a  general  description  of  the  methodology 
of  the  programmers  and  the  terminology  used  in  the  manual 
is  warranted. 

A  "physical  record,"  in  context  with  the  terminology 
used  in  the  Systems  Manual  is  the  "collection  of  data"  found 
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Specifically  those  in  the  file:  hi*  M.PDP 


in  one  record.  Tfn sn  submitting  a  program  written  on  punched 
cards,  the  input  record  length  is  limited  to  30  -  the  number 
of  characters  allowed  on  the  card.  A  disc,  of  course,  does 
not  have  this  limitation  and  the  record  size  can  be  extremely 
large.  (.In  the  OIPTS  system,  the  record  size  is  automatically 
defined  within  the  program  and  can  be  as  large  as  1634 
bytes.)  The  program  uses  equivalent  size  buffers  to 
accomodate  the  l/C  record  sizes  and  also  allows  for  variable 
sizing  of  buffers/record  size  should  the  programs  ce  run 
on  a  large  machine.  This  fact  is  academic  though  since  the 
current  installation  at  the  baval  Postgraduate  School  is  on 
the  PDP-11. 

A  "logical  record"  is  a  term  used  for  the  grouping 
together  of  data  which  are  related  insofar  as  the  programmer 
says  they  are.  Better  put:  "the  smallest  collection  of 
data  into  which  the  data  contained  in  a  file  may  be  divided." 
Por  example,  a  physical  record  of  200  bytes  could  be  divided 
into  ten  logical  records  of  20  bytes  each.  In  this  case, 
the  number  "10"  is  the  "blocicing  factor." 

Data  in  GIPTS  are  generally  buffered  in  named 
001  HOD ,  A  buffer  typically  consists  of  a  physical  record 
plus  some  "bookkeeping"  data.  Por  example,  a  physical 
record  in  the  "points"  (.PT3)  file  contains  data  on  ten 
points.  If  the  point  being  worked  on  by  CIPTS  is  not  in 
the  record  currently  in  the  buffer,  the  current  buffer  is 
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stored  in  the  PIS  file  and  the  correct  record  is  read  in. 

The  "logical  record"  needed  by  C-IFTS  (i.e.  the  point  being 
worked  on)  is  now  available. 

2.  Naming  Convention 

The  lTDB  consists  of,  typically,  ten  or  so  files 
(the  exact  number  depending  on  the  problem  being  modeled). 
Certain  administrative  files  are  kept  open  throughout  the 
life  of  a  problem  -  that  is,  until  deleted  by  the  user. 

These  files  do  not  contain  data  which  are  used  directly  in 
solving  or  displaying  a  specific  model.  Other  files  are 
temporary  or  "scratch"  files  and  are  deleted  prior  to 
leaving  the  module  which  opened  then.  Then  there  are  the 
files  containing  the  data  unique  to  a  model  which  are 
"passed  on"  from  module  to  module  until  the  model/solution 
is  completed.  All  of  these  files  are  the  Unified  Tata 
Base  -  the  focal  point  of  the  C-IPTS  system. 

At  the  beginning  of  each  module,  the  user  is  queried 
concerning  the  name  of  the  model.  The  first  time  that  this 
name  is  used  (usually  in  the  nodules  TUT.  'h  or  ‘TIT:  ),  the 
name  becomes  unique  until  the  problem  is  deleted  from  tme 
disc. ' 

Figure  4  is  a  sample  listin  of  the  files  built 
C-IPTS  for  the  job  "PIATT"  which  was  shown  in  previous 


'’This  cannot  ce  done  'ey  C-IPTS  but  must  be  done  with  the 
file  handler  -  see  section  III. 1.3. 

’  o 
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section.  As  the  problem  progresses,  the  number  of  files 
could  increase  and  eventually  take  up  a  0reat  deal  of 
disc  space  (users  should  keep  this  in  mind  when  creating  a 
problem  when  disc  space  is  at  a  premium). 

Two  other  files  exist  which  do  not  follow  the 
naming  convention  which  was  outlined  above.  These  are: 

'I  'TS 3. INT  and  '’IFT35.TST.  The  former  is  a  sequential, 
formatted  file  listing  all  the  "Hi;!.?"  command  answers  that 
are  available.  I.  requires  updating  as  changes  are  made 
to  the  system  and  is  not  tied  to  any  particular  problem. 

The  latter  file  is  used  by  OPTIII  (i.e.  optimization  program) 
and  is  strictly  for  time  estimates  for  the  problem  being 
completed.  The  user  normally  need  not  be  concerned  with 
this  file,  as  it  should  already  exist.  If  it  doesn’t,  this 
will  cause  minor  problems  and  could  be  easily  rebuilt  by 
running  the  module  TST.TSX  which  is  included  on  the  magnetic 
tapes  discussed  below  in  section  17.1. 

-ach  of  the  files  is  described  in  the  IITTS  System 
Manual  beginning  on  page  37  II-2.  Tor  those  interested  in 
modifying  the  ZIFTS  system  or  writing  an  interface  program, 
further  explanation  of  the  UD?  is  given  below  in  section  17. 

Z.  DOTUIiZNTATIC:;  o?  GIFTS 

The  source  listing  as  provided  by  the  I STL,  University 
of  ‘rizona,  is  liberally  filled  with  comment  statements, 
however,  the  interaction  of  the  approximately  300  library 
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subroutines  with  the  program  and  subroutines  within  the 
modules  is  so  complex  that  trying  to  understand  exactly 
what  a  program  is  doing  at  a  particular  time  is  virtually 
impossible  without  an  excessive  expenditure  of  time. 

The  user  normally  will  not  be  interested  in  the  source 
listing  but  rather  in  how  to  RUN  the  system.  The  remainder 
of  this  section  is  devoted  to  the  documentation  provided 
by  the  developers  on  how  to  use  the  system  to  solve  a 
problem. 

1.  Reference  Manuals 

There  are  several  manuals  which  are  of  interest  to 
both  the  GIFTS  user  and  the  systems  analyst  responsible  for 
building  or  maintaining  GIFTS  (see  Appendix  S) .  The  manuals 
are  provided  ;vith  the  GIFTS  system  by  the  University  of 
Arizona  and  are  kept  at  the  ITaval  Postgraduate  School  in 
the  Mechanical  Engineering  Department  Computer  Laboratory, 

Room  201 D,  Halligan  Hall.4 

Two  of  these  manuals  have  already  been  mentioned 
above:  "The  GIFTS  Systems  Manual";  and  the  "GIFTS  User's 
Reference  Manual.”  The  former  was  used  extensively  in 
attempting  to  understand  how  the  computer  program  worked 
and  to  understand  the  UD3.  The  latter  was  used  in  conjunction 


4IJot  all  the  manuals  have  been  provided  by  IGEL,  Univer¬ 
sity  of  Arizona,  as  they  are  yet  to  be  written.  For  example, 
the  "GIFTS  System  Installation  Manual,"  which  would  have 
been  useful  here,  has  not  yet  been  completed. 
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with  the  "GI7TS  Primer"  to  obtain  an  understanding  of  how 
tiie  system  operated  from  the  user’s  viewpoint. 

The  "Primer"  serves  as  an  excellent  aid  for  the 
cautious,  first-time  user  to  get  some  hands-on  experience 
with  the  system  and  to  see  what  the  system  can  actually  do. 
It  also  explains,  in  detail,  the  purpose  of  several  of  the 
commands.  The  included  examples,  besides  being  educational 
for  the  first-time  user,  are  very  useful  in  checking  the 
installation  for  accuracy. 


III.  THE  PDP-11 


The  GIFTS  system  has  been  installed  on  the  PDP-11/50, 
located  in  Room  500,  Spanagel  Hall,  at  the  Naval  Post-  ■ 
graduate  School.  The  choice  to  install  the  system  on  this 
particular  computer  was  based  on  its  availability;  the 
fact  that  GIFTS  had  already  been  brought  up  on  the  PDP-11 
elsewhere;  and,  that  the  main  computer  system  at  UPS,  the 
I  SI' I  360,  was  being  replaced  in  the  near  future. 

There  are  actually  two  PDP-1 1 s  available  in  the  Computer 
lab:  one  with  the  UNIX  operating  system,  and  the  other 
with  RSX-11M.  GIFTS  was  installed  in  the  latter  as  it  is 
limited  to  32X  work  (64K  byte)  segments  whereas  UNIX  allows 
only  a  16K  work  (32K  byte)  segment  size. 

A.  ORGANIZATION 

The  Computer  laboratory  at  the  Naval  Postgraduate 
School  falls  under  the  administrative  control  of  the 
Director,  Computer  Laboratories.  Under  his/her  control 
are  several  analysts/mathematicians  familiar  with  the 
RSX-11M  operating  system. 

3.  RSX-11M  OPERATING  SYSTEM 

The  following  are  descriptions  of  utilities  available 
under  RSX-11M  and  which  are  used  in  the  building  and  running 
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of  GIFTS.  The  descriptions  are  provided  here  primarily  as 
background  information  for  section  IT.  The  details  of 
the  following  utilities  may  be  found  in  the  appropriate 
PDP-11  manuals. 

.  1 .  10 GOT  ( HFI) 

"HFD"  is  the  logon  keyword.  For  the  Mechanical 
Dngineering  Department,  the  logon  is  "HSI  MFDFPT"  whereupon 
the  computer  queries  the  user  for  an  appropriate  password. 

The  logoff  "keyword"  is  simply  "SYF. " 

2.  User  Identification  Code  (UIO) 

The  UIO  is  assigned  by  the  Director,  Computer 
laboratories,  and  serves  two  primary  purposes  in  the  RSX-11M 
operating  system: 

a.  Identification  of  a  particular  user  for  security 
and  accounting  purposes;  and 

b.  Identification  of  the  user's  directory  on  disc. 

3.  Peripheral  Interchange  Program  (PIP) 

PIP  is  the  very  versatile  system  of  file  handlers 
which  is  used  to:  move,  delete,  copy,  rename,  etc.,  files 
created  on  disc. 

Some  knowledge  of  PI?  is  essential  to  any  prospective 


user  of  the  GIFTS  modules  on  the  PDP-11.  It  allows  for 
deleting  and  transferring  files  -  which  are  useful  "house¬ 
keeping"  functionsto  know. 
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Pile  Transfer  Program  (PIX) 

PLX  is  the  PDP-1 1  utility  for  handling  files  between 
disc  and  magnetic  tapes. 

5.  PORTRAIT  Pour  Plus  (?4P) 

The  P0RTRA7  compiler  used  to  build  the  GIPTS  system. 

The  syntax  for  this  system  allows  for  the  use  of  many 
"switches."  In  the  building  of  GIFTS  on  the  PDP-11  it  was 
only  necessary  to  use  two  switches: 

a.  /C0:20  -  This  switch  was  necessary  on  several 
of  the  subroutines  to  increase  the  number  of  allowed  con¬ 
tinuation  cards  from  the  default  (i.e.  5). 

b.  /TRjiTOXl'  -  This  switch  was  used  to  build  a 
separate  system  library  which  did  not  include  the  code 
necessary  for  tracing  in  the  event  of  an  object  time  error. 

This  omission  is  necessary  to  allow  the  two  largest  nodules 
to  fit  into  the  32X  word  allowable  segment  on  the  PDP-1 1 . 

(This  will  be  further  explained  in  section  17  below.) 

6.  Taskbuilder  (TK5) 

TDD  is  the  "linker"  used  under  ASX-11:  .  In  con¬ 
junction  with  command  files,  it  builds  executable  modules 
complete  with  overlays.  A  description  of  the  command  files 
used  for  building  GIPTS  is  given  in  section  IV.  Further 
knowledge  of  the  TUB  utility  would  only  be  necessary  if 
one  were  to  rebuild  or  modify  the  GIPTS  system  without  the 
help  of  the  techniques  which  will  be  demonstrated  in  section  V. 
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7.  Librarian  Utility  Program  (LPR) 

This  utility  is  used  to  create  and  modify  libraries 
of  files.  In  the  case  of  the  building  of  the  GIFTS  system, 
it  is  used  to  create  "system”  and  "module"  libraries.  In 
modifying  the  GIFTS  system  one  would  only  need  to  become 
familiar  with  the  syntax  of  two  "switches":  /IIT  =  (that  is, 
"insert");  and  /DE:  ("delete").  Examples  are  shown  in 
section  V. 

S.  Text  Editor  (LET) 

The  RSX-11II  system  at  the  IT aval  Postgraduate  School 
offers  two  text  editors.  "LDT" was  selected  because  of  its 
power.  Mith  a  little  imagination,  a  great  deal  of  time  can 
be  saved  in  making  major  and/or  repetitive  changes  to  a 
file  with  SET.  To  make  future  revisions  to  GIFTS,  it  is 
quite  obvious  that  a  knowledge  of  an  editor  would  be  necessary. 

9 .  Macro  Assembler  (MAC) 

This  is  the  keyword  for  assembling  macro  programs. 

For  example,  to  assemble  a  program  called  TEST. MAC,  one 
could  enter: 

MAC  TEST  =  TEST 

This  would  produce  an  object  module  called  TEST.  It  is  also 
possible  to  get  a  listing  of  the  prograa  with  all  external 


'’note  the  syntax  difference  in  the  use  of  "="  for  /IT. 
and  ":"  for  /EE. 
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references,  etc.  Por  details  concerning  this  and  other 
features,  a  user  should  refer  to  the  appropriate  PDP-11'7 
manual . 

10. 

RUN  is  the  command  under  RS.X-11U  which  causes  an 
executable  module  to  he  loaded  and  executed.  Por  example 
RUN  BUIKM.  Por  files  that  are  overlaid,  the  executable 
module  (with  a  default  file  extension  of  TSh)  will  need 
an  additional  file  with  the  extension  "ST3."  This  is  the 
"symbol  table  file"  which  is  also  built  at  the  time  of 
taskbuilding. 

1 1 .  Use  of  Command  Piles 

"Command"  files  are  ASCII  formatted  files  having 
an  extension  of  "CUD. "  A  Command  file  is  executed  by 
simply  inserting  the  character  before  the  filename. 
Por  example,  to  run  a  command  file  called  0IPTS5.CMD,  one 
would  type  in: 

@GIFTS5 

The  contents  of  the  file  would  be  executed  line  by  line. 

Another  way  in  which  command  files  can  be  used  is 
in  conjunction  with  a  utility  or  the  "ORTRAIT  compiler,  P4 
Por  example,  if  there  are  two  separate  P01TPPJT  programs  t 


be  compiled,  TESII.-'TN  and  TEST2.ETIT,  one  could  edit  a 
command  file  called  TEST1 . CI-TD  as  follows: 


>EDT  TEST1.CMD 
*1 

TEST  1  =  TEST  1 
TEST  2  =  TEST  2 
■£ctrl)*Z  6 

*exit 

To  execute  this  command  file,  one  types: 

E4P  "5TEST1 

This  method  can  also  be  used  for:  PIP,  TEE  and  13R. 


°CTR1  Z  is  the  combination  of  characters  which  allows 
the  user  to  leave  the  "input  mode"  in  EET. 


IV. 


BUILDING  CP  GIFTS  OK  THE  PDP-11 


The  process  of  building  GIFTS  can  be  broken  down  into 
a  few  logical  steps: 

1 )  Sorting 

2)  Compiling 

3)  library  Euilding 

4 )  System  Building 

5)  Cleanup 

To  simplify  some  of  these  time  consuming  processes  which 
must  be  completed,  the  author  has  written  a  "Pile  Sorter" 
program  (PILSOR)  which  effectively  reduces  the  "slave  labor1 
time  and  improves,  it  is  believed,  the  accuracy  of  this 
process. 

A.  SOURCE  TAPE 

The  PDP-1 1  version  of  the  GIFTS  system  arrived  on  an 
unlabelled,  ASCII-formatted,  nine-trac.c  tape.  Along  with 
the  tape  was  a  listing  of  the  names  of  the  files  and  the 
sizes  thereof.  The  files  can  be  broken  down  by  type  as 


follows: 

Concatenated  PORTRAIT  programs/subroutines:  29 

Overlay  Description  Piles:  15 

Macro  Programs  2 

GIFTS  Information  File  1 

Test  Programs  (FORTRAN)  3 

29 


The  listings  of  PORTRAIT  pro grans/ subroutines  are 
unusable  in  the  form  they  are  received  and  must  ce  separated, 
compiled,  and  the  object  code  placed  in  libraries  before 
the  taskbuilding  (linking)  process  can  even  begin.  The 
steps  that  v/ould  be  involved  if  this  separation  process 
were  to  be  done  manually  with  the  Text  Rditor  (TOT)  are: 

1 .  Rind  the  first  line  of  the  program,  subroutine  or 
function;  then 

2.  Rind  the  last  line  of  the  program,  subroutine  or 
function  (i.e.  "Ii7D")>  then 

3.  Trite  the  inclusive  lines  between  the  first  and 
last  lines  out  to  a  new  file;  then 

4.  .To  back  to  1.  until  an  RDR  is  reached. 

The  finding  of  the  first  and  last  lines  using  TOT  is  not 

difficult  (except  in  each  case,  one  must  look  for  either 

a  subroutine  or  a  function  since  both  occur).  Triting  to 

a  new  file  is  not  particularly  difficult  but  requires  a 

rather  lengthy  line  of  commands.  Ror  example,  to  write 

lines  10130  through  13450,  inclusive  to  a  new  file  named 

\ 

RII17A77.  RIR,  requires: 

V/R101  30 : 1  3450/ri:?it:ta:t.  rt:t/ttt 
It  can  be  imagined  how  long  it  would  take  to  do  this 
hundreds  of  times  (about  six  hundred  for  GIRTS)  without 
an  error!  Ror  the  reason  that  this  task  is  so  tedious 
and  fraught  with  peril,  the  author  wrote  RILSOR. 
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E.  SOTTING  0?  SOUPCL  LISTING 


1 .  description,  of  ?ILSO.I 

The  basic  T 1130  7:  program  accepts  as  input,  the  name 

7 

of  a  source  listing  file  containing  at  least  tv;o  subroutines 
or  one  main  program  plus  one  or  more  subroutines  ^ or  functions). 
The  following  restrictions  or  guidelines  concerning  the  use- 
of  7ILS0P.  exist: 

a.  There  are  no  "Eloch  Data"  subroutines  wit.iin 
the  source  listing  to  be  sorted; 

b.  If  a  listing  contains  a.  main  program  (vice  a 
subroutine  or  a  function),  it  must  appear  first  in  the  file; 

c.  In  all  cases,  the  sorted  program,  subroutines 
and  functions  will  have  to  be  compiled; 

d.  In  some  cases,  entire  systems  of  sorted  subroutines 
v/ill  have  to  be  compiled  with  the  "/TP:  HOLT  3"  switch  in  use; 

e.  In  all  cases,  tine  sorted  and  compiled  subroutines 
will  have  to  be  stored  in  a  library  called,  arbitrarily, 

11.012; 

f.  Comment  cards  preceding  the  first  executable 
statement  are  discarded  from  the  first  output  program; 


The  current  version  of  the  GI2T3  source  listings  are 
on  a  magnetic  tape  in  a  format  useable  under  the  TLX  utility 
of  the  LSX-11X  operating  system  (see  above,  section  III, 0.4). 
To  obtain  a  listing  of  a  particular  magtape  file,  it  would 
be  necessary  to  load  the  file  onto  disc  using  TLX  and  then 
printing  it  using  PIP. 


g.  The  input  listing  is  ’unaffected  by  FILSOR; 

h.  The  "I'D"  statement  images  must  begin  in 
column  seven  (otherwise  the  program  will  fail  to  recognize 
it  as  being  the  last  statement  in  the  program). 

All  the  FOR  TRAIT  source  listings  included  with 

g 

RIFTS  conform  to  the  above  restrictions. 

The  main  output  from  FILSOR  is,  of  course,  the 

separated  PORTRAIT  files.  The  files  are  named  according  to 

the  subroutine/function  name  or,  in  the  case  of  a  main 

program,  the  name  of  the  input  file.  For  example,  assume 

a  file  named  EXAM?!.. £XT  contains:  a  main  program  and 

three  subroutines  (subroutines  TEXT 1 ,  T2XT2  and  Function 

T2XT3).  The  results  of  running  FXA1TPL.TXT  through  PII30R 

would  be  to  create  four  new  files  called: 

EXAMP I.  ft:: 

•T3XT1  .ft:: 

T3^T2 . 

rp  tvp7  7  rn v 

u.  .—jj v. u.  y  •  i. 

The  original  file  3XAKP1. 3XT,  containing  the  concatenated 
PORTRAIT  files,  still  exists  and  is  unchanged  by  running 
FILSOR. 


3 

It  should  be  emphasized  that  in  the  first  program 
or  subroutine  in  the  file,  blank  or  comment  cards  pre¬ 
ceding  the  first  executable  statement  will  be  "lost. " 
Similarily,  blank  or  comment  cards  between  "3ITD"  and  the 
next  subroutine  or  function  within  the  listing  will  be 
lost.  Both  these  statements  apply  only  to  the  sorted 
routines  -  not  the  original  listing. 
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FI 1301  also  builds  tv;o  additional  files  while 
sorting  the  input  file.  Since  it  will  eventually  be 
necessary  to  compile  all  the  subroutines,  a  file  called 
113. CAP  (a  command  file)  is  built  which  allows  for  the 
compilation  of  all  program/subroutines  sorted  by  711801. 

As  stated  in  section  III. 3. 5,  two  possible  combinations 
of  "switches"  occurred  in  the  building  of  SIFTS:  one 
with  the  "/TA:IT072"  switch,  and  one  without.  The  "/S0:2C" 
switch  was  used  regardless.  71 ISO 7  Queries  the  user  in 
order  to  determine  whether  he/she  wants  to  include  the 
trace  capability  or  not. 

The  other  file  built  by  '1180.  is  c  .lied  "STUFF.  C.-.D.  " 
This  file,  in  conjunction  with  the  IFF.  utility,  will  store 
the  object  modules  compiled  with  113. d. 3  into  an  object 
library  called  11.013.  After  the  "STUFF"  process,  the 
library  11.013  can  be  renamed  using  PI?  to  avoid  confusion 
with  future  vILSO?.  operations. 

Appendix  C  is  a  complete  listing  of  FI1S0R.  An 
example  session  is  included  in  Appendix  1. 

A  more  complicated  version  of  FI1S0R  which  allows 
a  user  to  setup  an  input  file  with  a  list  of  several  input 
files  to  be  sorted  is  also  included  on  magnetic  tape.'* 

g 

This  version  is  called  vILSA2  and  requires  an  additional 
program,  STUFFr,  to  build  the  input  file,  loth  of  these 
modules  are  included  on  tape  and  are  executed  as  a  part  of 
the  automatic  "rUILDT"  command  file  discussed  below  in 
section?  aid  listed  in  Appendix  1. 


.  .ost  31  /  33  '..o chiles  .lust  7e  ovcrlrin  on  tue  2  _1— 11  i 
order  t.tat  they  can  fit  into  r.e::.or;*.  7-3  s  v.tax  invoiv 

with  the  tasktuilder  is  quite  extensively  described  in 
1  manuals  and  will  not  ce  duplicated  '.ere-,  2;vera 
examples  of  the  syntax  will  ce  sho vat  and  1/  these  means 
reader  will  he  able  to  appreciate  the  methodology  used 
the  722-11. 

i  .  hon-Cverlaid  h.oduies 

,.t  present,  there  are  seven  nodules  which  are  r. 
overlaid  and,  therefore,  are  the  simplest  to  "'build." 

It  is  only  necessary  to  compile  these  modules  and  tasnb 
( building  ar.  executable  module  and  "linhir.g"  v/it.t  exte 
references).  Zo  simplify  the  process  ever,  .tore,  co  .man 
files  are  normally  used  for  the  process  and  were  used  f 
building  21723. 

?or  example,  the  module  2  XT"  is  built  using  ah 
following  loan  and  Tile: 

2  ;i::7/  2/  :?=?.. r.:~,  n i  r 

/ 

:  77 2 U  =  )0C 

77113=1 5 

73 '  =  -1:6 

.437=37 : 7:2:3:10:11:12:13 


7he  switches  used  in  the  main  uir.e  of  the  7o.nna.nd  ile 
necessary  and  more  or  less  "boil-r  plots"  suite  cs. 


are  explained  in 

de  tail 

in 

the 

~D  ■ 

11  manuals.  7he 

•expression,  "mil’" 

71 "/  7" 

in 

the 

file 

indicates  to  the 

tas Scbui Icier  that 

beside 

s  t 

.1  e  v 

:;P-1  1 

system  library,  (on 

th 

777-11,  this  is 

vvp 

r\  *-  “ 

and 

ne  e  d 

not  be  referred  to  i 

n 

t  .e  CO'tnand  Pile 

as  it 

is 

auto. 

...atic 

ally  called  by  ?"?), 

a 

-ibrary  called  "'I'T  I?. Cl.?  is  called  in  order  to  resolve 


external  references.  :I“7LI3.' 
on:  compiled  ooject  modules  fro. 

" '  t  or'''  f  i  Vc  <?  • 

-  -W  W  .4  1/  _  _  J.  ^  ^  W  • 

Z~  : 2.  ' 

-  *> 

r.x-.-iili? ”? 


-  is  actually  made  up 
the  followin'  seven 


[O 


is  quite  possi 


?•  e  othc  r  lines  in  tae  co.  stand  til?  for  I 
so..'. e  explanation  as  tiny,-  are  controlled 
siz:  and  parameters  wit:. in  the  pro.; rare.  It 
ttat  para  :eters  in  u.-e  exis  -in  -  command  files  jovld 

c  .an  e  in  tie  future  as  t..«  :■!  77  sister,  is  update  i/v.c  lift 
;  terv.  1  ...17"  usi  totes  tue  siz. 
duffer.  he  recordsize  for  several  of  tre  '1  '7f  files  is 
quite  _u  ;e  (up  to  1634  bytes)  tut  since  not  ail  files  are 
called  'ey  every  nodules,  77X777  will  vary  between  modules, 
lue  size  of  .'.Xll'1  for  a  particular  module  car  be  cotputei 
by  referring  to  tne  table  on  sa  e  7'  -  '1.2  of  the  ’7  '77 


of  t  ■.  e  7  / 


o 


"UhlfS'  defines 


the  maximum  number  of  the  logical 
units  whereas  ’’ACTPIL"  assigns  the  number  of  active  files 
v.-hicl.  can  be  concurrently  open.  The  latter  is  variable 
ce tween  modules  and  is  quite  important  since  the  ICTf II 
parameter  causes  allocation  of  memory  at  the  time  of  task- 
building.  As  .'.any  of  the  modules  are  quite  tightl"  "packed 
into  the  3 2."  word  allowable  memory  segment,  the  extra  bytes 
available  'ey  adjusting  this  parameter  become  very  important 
”A3G”  fulfills  the  taskhuilder  requirement  that  eac 
logical  'nit  have  assigned  to  it  a  t.tysical  unit.  ~hus,  in 
:..e  command  file,  logical  'tr.it  six  is  assigned  (;..f g) 

to  the  terminal  ( T I : )  and  all  ~"’s  between  seven  and  13, 
inclusively,  are  assigned  arbitrarily  to  trie  "system” 
disc  v 3 1 : ) . 

Without  the  command  file,  each  of  the  steps  would 
h"  .  e  to  be  individually  typed  in.  fir.ee  a  command  file  -t.s 
built  in  this  case,  id  is  merely  r.ecessar”  to  type: 

tkb  print 

I.  is  worth  noting  here  tr.at  if  several  modul-m  •  m 
to  be  b  iilt,  tr.e  command  files  may  be  imbedded  in  another 
co  mm  and  file,  for  example,  take  th-  command  file  h.f'g.  :  f 
v;..icn  is  ir.de  up  of: 

tkb  print 
tkb  save-:  • 
tkb  residu 

it  -'il  •  r.t  be  execute,  ty  f-pir.g:  'roup. 


Overlaid  :.odules 


The  majority  of  the  3 IT?5  modules  are  overlaid. 

Some  of  tne  overlay  schemes  are  fairly  complicated  and  are 
difficult,  due  to  the  tashbuiider  syntax,  to  enter  at  a 
terminal.  Therefore,  as  with  the  non-overlaid  modules, 
command  files  are  used,  however,  now  "indirect"  or  "Overlay 
Inscription"  files  using  "Overlay  Description  language"  (GDI) 
are  o.iso  used.  (These  Tiles  are  commonly  referred  to  as 
**C~'T  .fi "i  os#  **  J 

The  Of.  file  is  built  with  the  text  editor  for  each 
module  and  describes  the  overlay  scheme  for  the  module. 


■'he  file  is  then  referred  to  by  the  m  command  file, 


::<c.  :pl2,  the  following  is  the  command  file  used  to  build 


II "IS,  notice  on  the  rirht  hand  side 


of  the  equal  sign  i 


expression:  -V'Jlll/iy.  The  /.MP 


3’..’itch  indicates  to  TIT  that  ohere  exists  a  file  on  disc 
called  V C:  1"  which  describes  the  overlay  scheme  Tor 


;he  module  (  Ti  -are  5). 


teat  no  object  modules  are 


?rred  to  diroctly  in  this  command  file: 

•  V-  ;T-=-|  7 

TJC"  =?lo 
ITT!  'T=n 

.  ..  -  ; ^ 

h  :=  T :  1  5 : 1 1 : 1  2 : 1  3 : 1 4 : "  5 


first  line  it.  the  CO.  file  indicates  the  ov  r 


i.  ..  h,  T,  C,  etc.).  ."no  ot.er  lines 


1 


indicate  the  choice  of  o eject  nodules  for  the  "Root"  and 
~he  various  overlays,  there  are  syntax  and  conn and  rules 
which  obviously  must  he  followed  in  building  an  Oil  file. 
Such  information  is  found  in:  "RSX-1 1”  fash  Builder 
Reference  Manual."  It  is  not  the  purpose  here  to  elaborate 
on  this  syntax. 

The  Command  ahd  ODL  files  for  building  C-I2T3  exist 
for  all  overlaid  nodules  and  are  on  magnetic  tape  for  the 
eventuality  that  the  system  will  need  to  be  rebuilt.  These 
files  are  the  core  of  the  work  necessary  for  building  GIFTS. 
Anyone  interested  in  vastly  revising  CISTS  would  need  to 
lenow  the  existing  structure  of  GIFTS  and  then  attempt  to 
reconstruct  the  effect  of  the  revisions  or  the  size  of 
modules.  As  stated  above,  some  of  the  nodules  are  very 
tightly  packed,  some  taking  up  to  greater  than  99  percent 
of  the  available  32..  words. 

1.  7.UILDI273  0?  II BRA.. 123 

.here  are  two  basic  types  of  libraries  built  from  the 
IBIS  files.  The  first  type  includes  the  two  separate 
system  libraries.  The  reason  for  having  a  second  "system" 
library  is  that  two  GIFTS  modules,  2ULHI3  and  AB3UIT,  simply 
cannot  fit  into  322  words  as  normally  built.  Thus,  a  second 
nearly  duplicate  library  is  built  using  the  "/f’f. :  1T0IT  : ,T 
switch  when  compilin  '.  The  effect  of  this  switch  is  to 


reduce 


he  size  of  the  object  nodule  by  about  ten  percent 


The  absence  of  the  "trace"  capability  rears  that  should 
an  error  occur  during  program  run  tire,  the  system  will 
not  inform  the  user  in  which  object  nodule  the  error 
occurred.  Again,  this  "pro  cion"  occurs  only  in 
and  AfS-rT. 

fhe  other  type  of  library  is  cabled  a  "nodule"  library. 
That  is,  for  every  executable  nodule  where  overlaying  is 
being  used,  a  library  of  the  object  modules  derived  from 
the  individual  program  listing  (vice  the  G-IITS  system 
library  listings]  is  cuilt.  This  approach  allows  the 
analyst  to  "xeep  trach"  of  which  object  nodules  are  needed 
for  each  overlaid  nodule.  Thus,  this  is  a  natter  of  con¬ 
venience  . 

In  figure  5  are  examples  of  how  the  two  library  types 
are  used.  ITote  that  in  every  case  where  the  switen  "/LI" 
is  seen,  the  preceding  filename  is  the  name  of  an  object 
library.  'There  the  switch  "/..I"  is  used  alone,  as  in: 

ITTT.il/LE,  the  meaning  is  that  a  cheer  through  the  library 
GITI'IT.OLB  will  be  made  tc  resolve  references.  There  a 
colon  is  attached  i,i.e.  the  THE  system  w ill  expect 

to  find  one  or  more  specifically  named  object  modules  which 
are  to  be  designated  as  being  part  of  a  particular  segment. 

T.  OVERLAY  SCHEMES  USED 

.'he  :na  netic  tape  received  from  I'd.,  diversity  o  f 
f rizoua,  included  the  overlay  schemes  used  at  the  Laval 
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Postgraduate  School  for  the  building  of  SI.'  S.  Pie  scheme 
are  actually  in  GDI.  file  torn.  Gh.an.--es  to  the  overlay 
scneno(s)  would  be  complete!  by  making  revisions  to  the 
respective  0D1  file  and  then  rebuilding  the  respective 
module ( s) . 

Installing  the  CrIPPS  system  on  another  computer  system 
could  necessitate  a  revision  to  the  schemes  cut  the  Oil 
files  are  a  good  point  for  departure. 

?.  DTP/DPIC"  0?  UPPPOPSSAPY  PITAS 

/.long  the  path  of  building  PIPPS,  one  accumulates 
several  files  that  are  extraneous  to  the  actual  running  of 
the  G-I7TS  system.  If  file  deletions  are  not  completed,  an 
accumulation  of  about  16,000  blocks  of  intelligence  on 
disc  (about  twenty  percent  of  the  maximum  capacity  of  the 
GIG  9762  disc  drive)  would  be  taken  up  by  G-IPPS.  Since 
the  executable  module  files  accumulate  to  only  about  4000 
blocks,  file  deletions  (using  PIP)  should  be  completed. 

The  method  for  doing  this  on  the  PDP-11  can  be  found 
in  the  appropriate  PDP-11  Manual.  Generally,  it  takes 
the  form: 

PI?  Pilename. Extension; Persion/DD 
""ild  cards"  are  permitted  for  filenames,  extensions  end 
version  names/numbers.  The  version  number  (or  wildcard) 
must  be  included. 
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A. .  files  necessary  to  rebuild  LIFTS  exist  on  two 
magnetic  tapes.  A  listing  of  the  contents  of  t~e  respective 
tapes  are  included  as  Appendix  7.  To  rebuild  LIFTS ,  it  is 
merely  necessary  to  load  the  tapes  and  type  the  following 
two  commands: 

7 LX  /RS=. Ill  :  [*,  ”]?.UILDT.C:D/rO 
J FIJI  IDT 

The  resulting  process  taxes  approximately  six  hours  to 
complete.  A  listing  of  3UIH)2.CXD  is  included  as 
Appendix  A. 


V. 


FaOCSTURT  ?0a  3E7I3IITG  GIFTS 


A.  TAXI  IT  G  XINOH  CHANGES 

It  should  be  remembered  that  each  module  is  listed 
separately.  In  addition,  there  are  five  files  of  sub¬ 
routine  listings  plus  two  assembly  language  files  which 
are  included  as  part  of  the  GIFTS  system  libraries  (two). 

It  should  be  quite  obvious  that  if  a  revision  to  a  single 
module  listing  is  necessary  then  only  that  module  will  need 
to  be  rebuilt. 

On  the  other  hand,  if  one  library  subroutine  is  changed 
it  would  be  wise  to  rebuild  the  entire  system  (■•unless  the 
modules  containing  the  revised  subroutine  can  be  isolated). 

1.  Changing  the  System  library 

The  following  steps  should  be  completed  in  revising 
the  system  libraries: 

a.  Edit  (TFT)  the  listing  (either  LIFFI  . TT',', 

115112 . KS'.f ,  LI 2R3 . NEV/ ,  IIFiU.NT'/  or  11535 . FT?) ; 

b.  Extract  the  subroutine(s)  which  have  been 
revised  (in  order  that  the  entire  library  need  not  be 
rebuilt) ; 

c.  Compile  the  subroutine  twice-once  with  the 
/TO: 20  switch  alone  and  again  with  the  /lR:i!0XE  switch; 


^3 

a.  Insert  the  object  modules  into  the  two 
libraries  -  GIFT1IB  and  G1IB2  by  using  the  LBA  utility; 
e.  Rebuild  the  C-IFTS  system. 

The  last  step  is  not  quite  as  difficult  as  it 
seems  since  the  command  and  ODL  files  are  already  built 
for  this  purpose.  The  entire  rebuilding  process  can  be 
done  by  a  series  of  TEB  statements.  Such  a  command  file, 
called  GIFTS5.CI-D,  is  shown  in  Figure  6  and  is  included  on 
the  tapes  mentioned  in  section  IV.  G.  By  merely  typing 
©GIFT35,  the  entire  GIFTS  system  will  be  built  in  approxi¬ 
mately  one  hour.  The  file  depends,  of  course,  on  the 
existence  of  the  command  files,  ODL  files,  GIFTS  system 
libraries,  and  the  respective  module  libraries  to  execute. 

A  listing  of  the  files  needed  to  execute  GIFIS3.CCH  are 
shown  in  Figure  7. 

2 .  Changing  a  Module  Library 

If  only  a  single  module  listing  is  revised,  then 
it  should  not  be  necessary  to  build  the  entire  Cf’TS  system. 

In  other  v/ords,  the  use  of  BUIIBT.ObT)  is  unnecessary  hers. 

Instead,  it  would  only  be  necessary  to  execute  the  steps 
which  are  demonstrated  in  Appendix  D.  The  OPTIC!  module 

J  - 

is  used  by  way  of  example  in  Appendix  D,  but  any  overlaid 
module  would  be  "rebuilt"  in  the  same  manner. 
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For  non-overlaid  ...odules,  it  is  necessary  only  to 
1 0 

compile  and  raskbuild  using  the  provided  command  files. 


I .  MAJOR.  CHARGES 

If  a  substantial  number  of  changes  to  the  GIFTS  system 

were  to  be  made,  it  may  be  necessary  to  rebuild  the  entire 

set  of  executable  modules.  Assuming  that  the  command  files 

1 1 

are  not  to  be  revised,  the  following  steps  would  be  followed 

1.  Revise  the  respective  listing(s)  using  the  Text 
Editor  (EDI); 

2.  Revise  the  two  tapes  using  FIX; 

3 .  Z'xe cute  ©BUI LIT . 

It  should  be  obvious  that  if  the  two  existing  tapes 
are  to  be  modified  that  a  new  set  of  tapes  will  need  to 
be  built.  The  FLH  utility  is  the  handler  for  this  process. 

It  should  be  noted  that  the  present  command  file,  BUI  IDT.  ID, 
is  cased  on  the  existence  of  two  separate  tapes  with  the 
contents  being  as  listed  in  Appendix  F.  In  this  appendix. 


1  0 

It  should  be  remembered  that  tne  default  extension 
for  a  FOX  TRAIT  file  on  the  PGP-1 1  is  "FIIC . »  The  TORI  RAX 
listings  provided  by  I GEL  had  the  extension  "NEW. "  There¬ 
fore,  when  compiling  these  programs  using  the  ’4?  compiler, 
use  syntax  as  follows  (for  the  file  called  REDOS. NEW) : 

~?A~D  ‘T'Tf ."'C-  '7T)^C  V  r-T 

1  1 

If  new  subroutine(s)  were  added  to  an  individual 
module,  then  the  respective  "ODD  File"  would  also  need  to 
be  revised.  It  is  also  possible  that  changes  to  existing 
subroutines  could  make  the  individual  module  greater  than 
32  with  existing  overlay  schemes.  Then,  a  revised  scheme 
...ay  ce  necessary  and  the  ODD  file  would  have  to  be  revised. 
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it  should  also  be  noted  that  the 


UiO  for  the  taps  file  is: 
go,fl.  This  UIO  is  presumed  when  ~uITDT  is  executed. 

0.  UPDATING-  OP  A  ALP  TILL 

There  exists  a  file  called  0I7T35.IA?  which  contains 
the  information  or  data  used  by  the  "HAJTP"  command  from  the 
various  GIFTS  modules.  It  will  be  necessary  to_use  an 
editor  to  change  this  file.  Revisions  would  be  needed  to 
this  file  only  if  updates  were  received  from  the  University 
of  Arizona. 
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Figure  2  -  GIFTS  Presemotion  of  PLATE  Input 


gure  3  -  GIFTS  Presentation  of  Stress  Contours  JOB  PLATE 
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MOD3L  PX'DPATIOi:  AID  2DI2IKC 


2ULXII  is  an  automated,  three  dimensional  plate  and  shell 
model  generator.  It  is  suitable  for  large  continuous 
structure  that  can  be  easily  modeled  by  repetitious  genera¬ 
tion  of  points  and  elements. 


DDITM  is  designed  to  update  and  correct  BULK.’ I  models, 
although  it  can  be  used  to  generate  simple  models  and  ones 
too  complex  for  3UIZAI. 


11103  accepts  information  regarding  external  and  dependent 
boundary  nodes  in  a  constrained  substructure. 


BULKS  is  a  three  dimensional  solid  model  generator.  One 
may  ash  for  the  display  of  the  edges,  and  may  add  and  dis¬ 
play  selected  point  and  element  slices. 


1  p 

The  descriptions  here  are  taken  from  tue  ”01  ITS  "sen's 
A.anual.  ” 

1  3 

Pln^.S,  as  of  the  date  of  mis  v.-riting, 
implemented  on  t.:e  PDP-11.  This  is  primaril 
size . 
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is  not  :*ch 
due  to  its 


LOAD  A1I3  LOULLAAL  SOLDI DIO" 


Alb LL ATI OP ,  DISPLAY  AITD  1DIIIPS 
LUIZP 


LULL]?  is  intended  to  allow  only  those  freedoms  which 
a  model  can  support,  thereby  relieving  the  user  of  the 
necessity  of  supressing  all  superfluous  freedoms  by  hand. 

3ULKLL 

3UIZL3  is  a  bulk  load  and  boundary  condition  generator 
designed  to  apply  load  to  models  generated  with  LTJIZb.  It 
may  be  used  to  apply  distributed  line  and  surface  loads 
and  masses,  presribed  displacements  along  lines  and  surfaces 
and  inertial  loads,  temperatures  may  also  be  applied  to 
lines  and  surfaces. 


ADI TIL 

3DITLL  is  a  displa;  and  edit  routine  intended  to  provide 
local  modification  capability  to  loads  and  boundary  condi¬ 
tions  applied  by  BULL12.  It  may  also  be  used  to  generate 
simple  loading  on  models,  or  loading  on  models  not  generated 
with  BULIi:.  Temperatures  may  also  be  applied  to  elements. 
After  DA3L  has  been  run,  the  thermal  ■and  combined  loads  may 
be  examined. 

LOADS14 

LOADS  is  a  load  and  boundary  condition  generator  for 
solid  models.  Loads  may  be  distributed  on  lines  or 


1  _,uaJo  ,  ac 
implemented  on 


of 


the  date 
LDP-1 1 . 


of  this  writing,  is  not  yet 
This  is  primarily  due  to  size. 
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surfaces.  Loads  and  boundary  conditions  nay  be  displayed 
on  point  slices. 

GLLLLAL  P'JLPOSL  CO! ZFUTATIGN AL 
:_:3  .IDSULI  DISPLAY  MO  DULLS 

Orflk 

OFIIL  is  a  band  width  optimization  program.  Although 
3-I7LS  is  designed  to  handle  problems  without  size  or  band¬ 
width  restrictions,  it  is  very  important  that  the  problem 
be  optimized  before  the  solution  procedes.  Experience  has 
shown  that  run  times  can  be  reduced  cy  a  factor  of  two  to 
ten  if  the  procedure  is  used.  OFTIIT  may  be  called  several 
rimes  in  a  row,  until  the  best  node  numbering  scheme  has  been 
achieved. 

r*  T  '? 

SLID?  performs  computation  of  the  stifi'ness  matrices  and 
assembles  ehem  into  the  master  stiffness  matrix. 

PLIOh 

Jj'Z 001  introduces  kinematic  boundary  conditions,  and 
decomposes  that  stiffness  matrix  by  the  Oholesky  method. 

DJ-L  computes  the  deflections  from  the  current  loading 
conditions  and  the  decomposed  stiffness  matrix.  If  tempera¬ 
tures  are  present,  thermal  forces  will  be  calculated  and 
added  to  the  current  applied  loads  before  solution. 


55 


ShAASS  computes  the  element  stresses  cased  on  the  curren 
deflections . 

vc?TTT  m 

ArSUL'T  displays  deflections  and  stresses.  It  has  many 
options  that  nay  be  used,  at  the  discretion  of  the  user, 
to  transform  the  results  for  optimum  comprehension. 

~:is  di?gs  iTAiuhAi  vibiiaiio::  ?Ag?iAii 

AUT'OL 

AUT01  is  ordinarily  used  to  generate  starting  loads 
for  the  subspace  iteration  to  compute  natural  modes  of 
vibration. 


STH5  performs  a  single  subspace  iteration  to  determine 
the  model's  natural  modes.  It  must  be  repeated  as  many 
times  as  necessary  to  obtain  convergence  to  the  desired 
extent. 

”1^  ■~iTpr^s  T 
(Dips'll  i:T-hGRAIIOy) 

taaai 

T.1AIT1  is  to  be  run  on  a  transient  response  model  imme¬ 
diately  after  stiffness  assembly.  It  is  used  to  specify 
the  time  step  to  be  used  in  the  integration  process. 
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TRAIT  2 

TRAIT  2  is  run  after  IRA1T1  and  D2C0I-I.  It  computes  the 
displacement  matrix  for  time  I. 

TRAITS 

TRAITS  maintains  and  plots  histograms  of  the  displace¬ 
ments  ox  up  to  four  different  freedoms. 

HITS  COiTSTRAIITAD  SUBSTRUGTURIITG- 

\  rt  rr  \  ^ 

rx '.r  1— filT— J 

P.ZDGS 

Before  a  C0SU3  module  may  he  used  in  a  master  analysis 
run,  it  must  be  preceded  by  program  RRDCS  to  form  a  reduced 
stiffness  matrix  and  a  reduced  load  matrix  (if  there  are  any 
loads  associated  with  the  C0SU3). 


—  n 

5  i 


7 

t 

i 

APPENDIX  E 

USD  0?  DIETS  MANUALS1 

DIETS  USED 1  S  XEEEREITCE  MANUAL 

"Contains  complete  and  detailed  description  of  all 
DIETS  commands  and  computational  procedures.  It  is  meant 
as  a  source  of  information  for  the  experienced  user. " 

DIETS  SYSTEMS  MANUAL 

"Contains  detailed  information  on  the  code,  data  base 
and  program  structure.  Useful  for  those  undertalcing  pro¬ 
gram  conversion  or  enhancement. " 

Though  there  is  a  great  deal  of  detail  concerning  the 

UDD  and  program  structure  (for  the  ECLIPSE  Computer),  there 

is  really  insufficient  information  to  get  started  in  a 

"program  conversion  or  enhancement."  There  are  several 

terms  and  acronyms  which  are  undefined  in  the  description 

where  knowledge  of  the  other  manuals  are  essential  for  unde 

standing. 

^T^nc  -DDT  ?.-m 

_L  —  *. ».  -L  a 

"...  useful  to  new  users,  and  to  exercise  the  system 
on  a  new  installation,  or  check  out  a  new  version  of  the 
program  on  an  existing  installation  .  .  .  Tutorial  .  .  . 

Solved  Examples." 

This  manual  is  excellent  for  the  intended  purposes. 

Anyone  seriously  intending  to  use  the  system  should  spend 
several  hours  with  this  manual  and  the  computer. 

■  -  —  -  \ 

4  C 

'  remarks  in  quotation  marks  are  taken  directly  from 
pages  DPE.IM-1-3  Sc  4  from  the  DIETS  Primer. 


GIFTS  INSTALLATION  MANUAL 


"Designed  to  help  those  attempting  to  install  the 
program  on  their  own  system.  Describes  implementation 
and  test  procedures." 

This  manual,  as  of  this  writing,  is  not  implemented. 

It  is  hoped  that  with  respect  to  the  PDP-11,  this  thesis 
provides  some  of  the  information  needed. 

GIFTS  THEORETICAL  MANUAL 

"Dontains  mathematical  fundamentals  and  algorithms 
underlying  mesh  generation,  element  characteristics  and 
solution  procedures.  Of  use  to  those  wishing  to  assess 
the  properties  of  the  mathematical  model  used,  or  modify 
the  pro  gran." 

GIFTS  MODELLING  GUIDE 


"Aimed  at  the  program  user.  Discusses  practical 
aspects  of  finite  element  modelling  in  general  and  pays 
particular  attention  to  elements  and  procedures  imple¬ 
mented  in  the  GIFTS  system. " 

Not  implemented  as  of  this  writing. 

GIFTS  POCKET  MANUAL 

"A  handy  pocket-size  reference  manual  containing 
complete,  but  terse,  summary  of  information  in  the  GIFTS 
Users  Preference  Manual.  Used  mainly  as  a  quick  reference 
manual  to  be  used  while  working  on  a  terminal  by  the 
experienced  user." 

Tmphasize  experienced! 
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apphiii  i 

saipaa  sfssioi:  aha 

Jhe  following  is  a  listing  from 
111301.  It  has  been  annotated  to  ir 
is  going  on  and  the  reasons  for  the 
Ihe  Tlllil. Oil  file  executes  thi 
"automatically11  with  the  exception  1 
3ioi  of  l-TISO?.  is  need  ad  9.3  v/ell  8.s 
(which  generates  the  answers  to  the 
ashed  below).  Ill  Ill,  of  course,  a] 
files  from  magnetic  tape. 


-t  t  1 

U-  —  -Iw-W-  k 

an  actual  run  with 
idicate  wh at  actual 
various  steps, 
s  entire  process 
hat  the  711312  ver 
the  S1U1A1.1SA  fil 
II ISC h  questions 
.so  reads  the  neces 
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>p:p/li 


OIRECTORY  OPS  C  160  ,533  O) 

30-AUC-80- 15  16 


OPTIM  OOL  ,47 

1 

30-AUC-80 

15 

33 

FILSOR. TSK  ,2 

51 

C  30-AUC-80 

15 

33 

OPTIM  NEW  ,1 

53 

30-AUC-80 

IS 

33 

OPTIM. CMO  ,10 

I  . 

.  30-AUC-80 

15 

33 

GIFTLIB  OLB  ,1 

592 

C  30-AUC-80 

15 

45 

TOTAL  OF  698  /698 

BLOCKS 

IN  5  FILES 

>RUN  FILSOR 

***FILE  SORTER*** 

(2) 

"/TR  NONE"  SWITCH  OESIREO  FOR 

COMP  I LE? 1 Y 

OR  N) 

TYPE  IN  NAME  OF 
TT36  --  STOP 

>F4P  OLIB 

FILE  INCLUOINC  EXTENSION 

(3) 

OPTIM 

>PIP  *. OBJ/LI 

OIRECTORY  0P3  C 160  ,531 
30-AUC-80  15; 48 

(4) 

OPTIM  08J  ,1 

1 

30-AUC-80 

15  46 

BAND  OBJ  ,1 

6 

30-AUC-80 

15  47 

INOPT  OBJ  ,1 

5 

30-AUC-80 

15  47 

OPT  OBJ  ,1 

10. 

30-AUC-80 

15  47 

SWAP  OBJ  ,1 

3 

30-AUC-80 

15  47 

TEROPT . OBJ  ,1 

14 

30-AUC-80 

15  47 

TOTAL  OF  39/50 

BLOCKS  IN  6 

FILES 

(5) 

>LBR  L1/CR  39  6  6  OBJ 

(6) 

>CSTUFF 

(71 

>LBR  L1/IN-0PTIM 

>LBR  L I / I N-BANO 
>LBR  L1/IN-IN0PT 
>LBR  U/IN-OPT 
>LBR  Ll/IN-SWAP 
>LBR  L 1 / I N-TEROPT 
>0  <EOF> 

>PIP  OPTIM. OLB-LI  OLB/RE  (8) 

>TKB  OOPTIM  (9) 
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>P I P/L I 


(10) 


0IRECT0RY  0P3  [J'60,53] 
30-AUC-80  15  51 


STUFF . CMO  ,  1 

1 

OPTIM. OOL  >17 

1  . 

LIB. CMO  >1 

1  . 

FILSOR  TSK  ,2 

5 1  . 

OPT  IM  NEW  .1 

53 

OPTIM. FTN  ,1 

2  . 

OPTIM  CMO  >10 

1  . 

BAND  FTN  >1 

7 

1N0PT  FTN  >1 

7  . 

OPT  FTN  >1 

18 

SWAP  FTN  >1 

1 

TEROPT  FTN  ,1 

1 1 

OPTIM  OBJ  >1 

1  . 

BAND. OBJ  >1 

6. 

INOPT  OBJ  >1 

S . 

OPT  OBJ  >1 

10 

SWAP  OBJ  >1 

3. 

TEROPT. OBJ  >1 

11 . 

CIFTLIB  0L8  >1 

592 

OPTIM  OLB  >1 

10. 

OPTIM  TSK  ,1 

209 

OPTIM. STB  ,1 

6. 

30-AUG-80  15  16 
30-AUO80  15  33 
30-AUL-80  15  16 
0  30- AUC-80  IS  33 

30-AUC-80  15  33 
30- AUC-80  15  16 
30-AUC-80  15  33 
30- AUC-80  15  16 
30-AUG-80  IS  16 
30-AUC-80  15  16 
30-AUC-80  15  16 
30-AUC-S0  15:16 
30-AUC-80  15  16 
30-AUC-80  15  17 
30-AUC-80  15  17 
30- AUC-80  IS  17 
30-AUC-80  15  17 
30-AUC-80  15  17 
C  30-AUC-80  15  IS 
30-AUC-80  15  18 
C  30-AUC-80  15  19 
30-AUC-80  IS  51 


TOTAL  OF  1016  /1086  8L0CKS  IN  22  FILES 


>PIP  *  FTN  >*/0E  (11) 

>PIP  * .  08  J ,*/DE 
>PIP  *  CMD  ,*/0£ 

>PIP  *  OOL  >*/0£ 

>PIP  * . 0L8  ,*/DE 
>PIP  FILSOR  TSK  >*/0E 
>PIP  OPTIM  NEW  >*/□£ 

>P I P/L I 

0*1 


DIRECTORY  0P3  C 1 60  ,53] 

30-AUC-80  15  52 

OPTIM  TSK  >1  209  C  30-AUC-80  15  19 

OPTIM  STB  ,1  6.  30- AUC-80  15  51 


TOTAL  OF  215  /219  BLOCKS  IN  2  FILES 


"0 


(1)  2he  first  thing  done  is  a  !'?I?/LI "  which  lists  all 
files  in.  the  directory.  In  this  case,  the  response  indicates 
that  we ’ re  in  directory  1  SO, 53.  file  files  listed  are  all 

she  files  needed  to  build  OPfLU.  If  273117  or  fulfil  were 
being  built,  then  11122  would  replace  "I 7211 2  as  the  1X722 
"System"  library.  Also,  as  a  means  of  differentiating  the 
171113  and  22SUL7  module  libraries  (see  section  17.2)  these 
libraries  are  arbitrarily  referred  to,  in  the  command  files, 
as  271111  and  121711 ,  respectively. 

(2)  711202  is  executed.  It  responds  by  as hint  two  questions 


before  proceeding. 


(3)  Hie  sorted  pro  gram./ subroutines  are 
using  the  command  file:  LI'' : '.ID  (which 


compiled  separately 
was  re ce rated  tv 


711307.  (see  listing  in  iten  (10)  below)).  If  an  error  were 
generated  during  compile,  the  compiler  would  indicate  which 
subroutine  had  the  error(s).  This  would  not,  however, 
inhibit  the  further  completion  of  compilation. 

(4)  This  is  a  listing  of  the  "Object"  files  generated  by 
the  347  3113  command. 

(3)  Note  that  39  blocks  in  six  files  were  generated.  v.:se 
numbers  are  critical  in  that  they  are  used  to  create  a 
library  in  the  next  step. 

(5)  Using  the  "LBR"  utility,  a  library  "11 .013"  is  created, 
.he  decimal  points  are  parts  of  the  syntax  in  this  command 


as  the  omission  of  ahem,  indicates  octal  numbers . 


n  * 


"LI”  is  used  only  be  causa  the  file,  built  rr 

.TL3C?  is  looking,  arbitrarily,  for  a  object  library  call 

LI  . 

(7)  Library  11.013  is  "stuffed?  In  the  case  of  this 
command  file,  each  command  is  subsequently  listed  'until 
and  /30F^  is  encountered.  In  this  example,  six  ob.jcct 
modules  have  been  inserted  into  library  11.013. 

(3)  Using  PIP,  the  library  LI  .CLP  is  renamed:  CPU.  .CLP 
Phis  is  z..e  library  name  which  v/ili  be  used  by  0PTI3I .  ILL 
v/hen  taskbuilding  CP  TIM. 

(.3)  CPTIl-I  is  finally  "taskbuilt. " 

(10)  A  listing  of  the  files  which  have  been  generated 
while  building  the  executable  nodule,  OPTIL.TSL,  and  the 
symbol  table  file,  0TPIM.ST2.  Lots  that  the  sum  of  the 
space  taken  up  by  the  files  is  over  1000  blocks. 

(11)  Housekeeping.  Those  files  unnecessary  to  the  exacu 
tion  of  the  OPT II!  nodule  are  deleted  by  the  seven  PI? 
directives  shown. 

(12)  A  listing  of  what  remains:  the  two  files  necessary 
to  execute  optimization. 
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DIRECTORY 

01-SEP-80 

HT0:C20.1T 

LI8R1.NEU 

125. 

01-SEP-80 

LIBR2.NEW 

172. 

01-SEP-80 

LIBR3 . NEW 

172. 

01-SEP-80 

LIBR4.NEW 

260. 

01-SEP-80 

LIBR5.PDP 

166. 

01 -SEP-80 

BULKLB.NEW 

351. 

Ol-SEP-SO 

BULKM.NE'W 

577. 

01-SEP-80 

EDITH. NEW 

449. 

Ol-SEP-SO 

BULKF.NEW 

20. 

01-SEP-80 

EDITLB.NEW 

263. 

01-SEP-80 

STIFF. NEW 

164. 

01-SEP-80 

DECOH.NEW 

23. 

01-SEP-80 

STRESS. NEW 

229. 

01 -SEP-80 

AUTOL.NEW 

26. 

01 -SEP-80 

RESULT. NEW 

544. 

01-SEP-80 

TRAN1 .NEW 

24. 

Ol-SEP-CO 

TRAN2 . NEW 

26. 

01 -SEP-80 

REDCS.tIL'W 

104. 

Ol-SEP-SO 

LOCAL. NEW 

120. 

01-SEP-80 

SAOEK.NEW 

8. 

Ol-SEP-SO 

RESXDU.NEW 

20. 

01-SEP-80 

PRINT. NEW 

20. 

01-SEP-80 

TEST. NEW 

2. 

0 1 -SEP-80 

BULKS. NEW 

646. 

01 -SEP-80 

LOADS. NEW 

551 . 

01-SEP-80 

OPTIH.NLW 

52. 

01 -SEP-80 

DEFL.NEU 

115. 

01-SLP-80 

TRANS. NEW 

91  . 

01 -SEP-80 

DEFCS.NEW 

152. 

Ol-SEP-SO 

TEST2 . NEW 

3. 

01 -SEP-80 

TSTF’L  T  •  NEW 

6  ♦ 

01-SEP-80 

SUBS. NEW 

52. 

Ol-SEP-SO 

TOTAL  OF  5533.  BLOCKS  IN  32.  FILES 
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DIRECTORY  MTl! 
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TRANS. ODL 

STRESS. ODL 
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REDCS.ODL 
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EDI  TLB. ODL 
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EST.FTN 

FILSOR.FTN 

FILSR2.FTN 

STUFFE.FTN 

FILSOR.TSK 
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TOTAL  OF  520.  BLOCKS  IN  51.  FILES 
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Digital  equipment  Corporation,  JQPTJLDT  ?our-Plus,  User's 
luide,  1977. 

Digital  equipment  Corporation,  PDP-11  70P.C..AIT,  lanruars 
Deference  Guide,  1977. 

Digital  Dqui orient  Corporation,  DSX-11D,  Beginner’s  Cuide, 
1977. 

Digital  equipment  Corporation,  P.SX-11X,  Cask  Builder 
Do ferer.c a  Panual ,  1973. 
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